home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / il / ilExpImg.z / ilExpImg
Encoding:
Text File  |  2002-10-03  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiillllEEEExxxxppppIIIImmmmgggg((((3333))))        IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll        iiiillllEEEExxxxppppIIIImmmmgggg((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllEEEExxxxppppIIIImmmmgggg - performs pixelwise exponentiation of an image
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      ilLink : ilImage : ilCacheImg : ilMemCacheImg : ilOpImg : ilMonadicImg :
  13.      ilLutImg : ilArithLutImg
  14.  
  15. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  16.      #include <il/ilExpImg.h>
  17.  
  18. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      ilExpImg performs pixelwise exponentiation of any valid IL image.  An
  20.      image of any data type can be given as input.  The proper data
  21.      conversions are performed to ensure output is of an appropriate type for
  22.      the range of values the exponentiation produces.  The smallest data type
  23.      that is produced is _i_l_C_h_a_r.
  24.  
  25.      Exponentiation is computed for any base specified. Common choices are
  26.      base 10 or natural base _e. The basic computation is defined as:
  27.  
  28.                                basepixel*scale+bias
  29.  
  30.      The functions provided by the standard math library, libm, are employed
  31.      to compute the exponentiation. The eeeexxxxpppp() and eeeexxxxppppffff() are used to compute
  32.      the base _e exponents for double and float data, respectively.  Similarly,
  33.      ppppoooowwww() and ppppoooowwwwffff() are used to compute the base _e exponents for double and
  34.      float data, respectively.
  35.  
  36.      The minimum and maximum pixel values are adjusted based on the input
  37.      minimum and maximum pixels and the operaton performed. This is done to
  38.      facilitate proper scaling of the data when displayed.
  39.  
  40. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  41.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
  42.  
  43.           ilExpImg(ilImage* inImg = NULL, double expBase = 0,
  44.                    double scale=1., double bias=0.)
  45.  
  46.      SSSSeeeetttt bbbbaaaasssseeee vvvvaaaalllluuuueeee
  47.  
  48.           void setBase(double expBase = 0)
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllEEEExxxxppppIIIImmmmgggg((((3333))))        IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll        iiiillllEEEExxxxppppIIIImmmmgggg((((3333))))
  71.  
  72.  
  73.  
  74. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  75.      iiiillllEEEExxxxppppIIIImmmmgggg(((())))
  76.  
  77.           ilExpImg(ilImage *inImg, double expBase = 0,
  78.                    double scale=1., double bias=0.)
  79.  
  80.  
  81.           Constructor for this class. The parameter, _i_n_I_m_g, is a pointer to
  82.           the input image; _e_x_p_B_a_s_e indicates the base to be used in the
  83.           exponentiation.  If _e_x_p_B_a_s_e equals zero, then the natural base, _e,
  84.           is used.  The optional scale and bias are applied to the result of
  85.           the exponentiation.  These can be used to scale the result to fit in
  86.           a smaller data type if desired.
  87.  
  88.      sssseeeettttBBBBaaaasssseeee(((())))
  89.  
  90.           void setBase(double expBase = 0)
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.